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Lesson 1: Naming Conventions 


+ After successfully completing this lesson, you 
will be able to: 


« Use correct naming for all publicly exposed 
identifiers 


Naming Patterns 


+ Only for publicly exposed identifiers 
+ Just what we document 
+ NOT a source coding convention 

+ PascalCasing: Each word starts with an 
uppercase letter 

+ camelCasing: First word is lowercase, others 
uppercase 


Naming Patterns 


+ All types and publicly exposed members are 
PascalCased 
+ Parameters are carnelCased 
+ These show up in Microsoft® IntelliSense® 
and does 
+» Abbreviations that are longer than two letters 
are cased as words, otherwise ALLUPPER 


+ IO vs. Html 


Hungarian Notation 


-= Do not use Hungarian notation in publicly exposed 
APIs and parameter names 


public class CMyClass { 
int CompareTo (object objValue) {..} 
string lpstrName {get;} 


int iValue {get;} 


Hungarian Notation (continued) 


+ The prefix codes are arbitrary and difficult to 
learn 
+ They make it harder to read an identifier 
name 


+ Hungarian was developed for a time when 
languages were loosely typed and IDEs were 
not as powerful 
+ Example: “out” and “ref” parameters 

information now conveyed at the call site 


Interlocked. Increment (ref i) 


a 


Technica : 


Naming Patterns 


+ Identifiers should be readable 
+ Do not use underscores 
+ Do not use all caps 
+ Do not use Hungarian 


+ Properties that return arrays\collections are 
plural 


«Example: Type.Getembers()} 
+ Instead of IpcUserName use userName 
„ Instead of MAX_VALUE use MaxValue 


Naming Patterns (continued) 


+ Familiar to many users 
„ Used consistently in the Framework 


public 
int 


Class and Interface Naming 


+ Do not prefix class names with “C” 
+ Class is the default 
+ Noise 


ip 


+ Do prefix Interface names with 


+ Makes them stand out—different from 
classes 


Naming Issues 


+ Good naming is extremely hard 
+ Be meaningful but brief 
+ Use U.S, English 
+ Example: Colour vs, Color 
+ Avoid abbreviations 
„ Use the “Google Test” 
+ Consider the principle of least surprise 
„ Look for prior-art 
+ Ex: NumberOfElements vs, Count 


Type Naming 


+ Choose type names that consist of nouns or 
noun phrases—examples: LegalDocument, 
FileSystem etc. 

« If you're deriving from core types, add a suffix 
to identify the type: 

+ Argument&xcepton 
+ FileStream 
+ ClickEventArgs 


Method Naming 


+ Methods are means of taking action 
» Use verbs or verb phrases 


+ Also helps distinguish methods from type 
names 


public void Remve (object item) 


protected void GetObjectData(..) 


Parameter Naming 


+ Parameter names are displayed in visual 
design tools, Intellisense, and class browsers 
„ Use descriptive names based on the 
parameter's meaning rather than the 
parameter's type 
+ Example: “maxValue” rather than “i” 


„ Use camelCase 


Exercise: Fixing a Broken Class 
Definition 


+ Fix this class definition ta conform to naming 
conventions: 


public class HtmlEncoding { 
public const string DEFAULT_NAME = "Htm]3.2"; 
public HtmlEncoding Cint iCount) {..} 
public string Tagrame {get {..}} 
public bool UseIoCompletionPort {get {..}} 
protected void _coresetvalue (double value) 


private IntPtr ptrValue; 
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Technical 


Lesson 1 Summary 


„+ A consistent naming pattern is important 

+ Identifier readability is key 

+ Use PascalCasing for types and publicly 
exposed members 

„ Use camelCasing for parameter names 

+ Interfaces are prefixed with “T” 

+ Class are NOT prefixed with “C” 
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